Release 10.1A: OpenEdge Deployment:
Startup Command and Parameter Reference

Calling parameter files

To call an additional parameter file, use the Parameter File (-pf) startup parameter in the OpenEdge startup command line or in a CONNECT statement.

Calling a parameter file in a startup command

From a startup command line, use the Parameter File (-pf) startup parameter to call the parameter file. Enter one of the following commands:

Operating sytem	Syntax
UNIX	pro sports -pf filename.pf
Windows	prowin32 -1 sports -pf filename.pf (Specify in the Command Line field of a Shortcut Properties dialog box.)

The filename can be any valid filename. OpenEdge combines all parameters on a command line with those in the parameter file. If the same parameter is mentioned more than once, the last occurrence takes precedence. For more information on startup parameters, see Chapter 4, " Startup Parameter Descriptions."

Calling a parameter file in a CONNECT statement

Use the following syntax to specify a parameter file in a CONNECT statement in a Progress® 4GL procedure:

CONNECT -pf sports.pf

For example, this procedure connects using a parameter file called new_york.pf:

new_york.p

UPDATE ny_user ny_password BLANK. CONNECT -pf new_york.pf -U VALUE(ny_user) -P VALUE(ny_passwd) NO-ERROR. IF NOT CONNECTED("new_york") THEN MESSAGE "Connection to New York office failed".

Calling multiple parameter files

You can use the -pf parameter as many times as you like on a command line. This lets you specify application-specific parameters in one parameter file, database-specific parameters in a second parameter file, and user-specific parameters in yet another parameter file. It also allows you to connect to multiple databases from the same command line or CONNECT statement.

When connecting to more than one database, the startup parameters must appear after the corresponding Physical Database Name (-db) parameter and database name. If connecting to more than one database, consider putting all the database-related parameters in a parameter file, then add the -db parameter to the top of the file. To support earlier releases, OpenEdge assigns any startup parameters that precede all database names to the first database on the command line.

OpenEdge processes parameters from left to right. Each -pf parameter encountered is processed first before the next top-level parameter is evaluated. If a parameter file specified by -pf contains another -pf parameter, the nested parameter file is evaluated before resuming the top-level processing.

Note: If the same parameter is mentioned more than once, the last occurrence takes precedence.